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Count  is  the  number  of  bytes  to  be  transmitted 
between  the  file  represented  by  'filedes'  and  the  byte  array 
represented  by  'buffer'.  Mbytes  is  the  number  actually 
transmitted.  For  the  read  call/'  'nbytes*  may  be  zero  to 
indicate  the  end  of  file;  in  either  case/-  minus  one  will  be 
returned  if  there  was  an  error. 

For  each  open  file*  the  system  maintains  a  pointer 
to  the  next  byte  to  be  read  or  written.  If  n  bytes  are 
transmitted/  the  pointer  advances  n  bytes.  Data  written  to 
a  file  affect  only  those  oytes  in  the  file  which  are  indi- 
cated by  the  position  of  the  write  pointer  and  the  count;  no 
other  part  of  the  file  is  changed.  If  the  system  pointer 
indicates  that  any  bytes  being  written  would  lie  beyond  the 
end  of  the  file*  the  file  is  enlarged  as  needed. 


Once  the  user  has  finished  processing  a  file/-  it 
should  be  closed.   This  is  affected  with  the  following  call: 

close(  f i ledes  ) ; 

Although  it   is   not   absolutely   necessary  to  do  a 

specific  close  on  a  file  when  finished/' '(the   system   closes 

all   files   when  a   program   exits)/  it  is  a  good  practice* 

since  the  user  is  allowed  only  sixteen  open  files. 

There  are  several  additional  system  calls  related  to 
I/O  which. wilt  not  be  discussed  in  detail.  A  few  of  the 
fit  ore  notable  ones  allow  the  user  to:  get  the  status  of  a 
file/,  change  the  protection  or  ownership  of  a  fite>  create  a 
file*  create  a  directory/'  make  a  link  to  an  existing  file* 
and  delete  a  file.  For  further  information  concerning  the 
different  I/O  calls  the  reader  is  directed  to  The  UNIX 
Programmer's  Manual/  fifth  edition*  K.  Thompson/  and  D.  M. 
Ritchie*  June  1974. 

The  user  communicates  with  the  network  via  these 
same  system  calls.  For  example*  if  one  wished  to  connect  to 
the  the  PDP-10  at  Harvard*  the  following  sequence  of  calls 
might  be  used. 


filedes  =  open(  "/dev/net/harv" *2  ); 
if(  filedes  <  0  ) 

printfC  Harvard  is  dead"); 
else 

whileC  (nbytes=read(f i ledes/buf *80))  >  0  ) 
write (  0*buf*nbytes  ); 

The  open  instructs  the  system  to  open  a  Telnet  connection  to 
Harvard/  if  minus  one  is  returned/  the  program  prints  a  mes- 
sage and  exits*  otherwise  the  program  will  read  any  bytes 
sent  by  Harvard  and  print  them  out  on  the  controlling  tele- 
type. This  will  go  on  until  Harvard  closes  the  connection 
(Read  will  return  minus  one  when  the  connection  is  closed). 
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UNIX    Telnet 


In  order  to  communicate  with  remote  hosts  on  the 
ARPA  network/  one  first  Logs  in  to  UMIX  as  a  normal  user. 
The  user  then  runs  a  program  Telnet/  which  after  announcing 
itself    leaves    him    with    several    options. 


He  may  co 
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ntinue  with  his  normal  UNIX  activities. 
UNIX  command/  it  will  initiate  the  re- 
lel  task/-  in  the  same  manner  as  the  UNIX 
the  Shell).  Since  this  may  be  done  re- 
or  not  a  network  connection  is  open/  the 
usly  receive  output  from  a  foreign  host's 
onverse  with  the  local  UNIX  system. 

elnet-user  opens  a  connection/  Telnet 
name  and  any  special  parameters/  and  does 
ial  file  corresponding  to  that  host, 
returned/  the  connection  is  open.  Any 
ed  from  the  terminal  not  containing  es- 
sent  to  the  network  file.  Any  data  r  e  - 
to  a  read  on  the  network  file/  is  written 
ri  t er . 


Communication  continues  with  the  host  until  the  user 
wishes  to  close  the  connection.  The  user  simply  makes  this 
known  to  Telnet  via  a  command/  and  Telnet  does  a  standard 
close  on  the  network  file.  The  negotiation  of  closing  the 
network  connection  is  left  to  the  system/  freeing  the  user 
for  other  computational  work. 

There  is  some  character  translation  and  invisible 
control  information  passed  back  and  forth  between  the 
foreign  host  and  the  Telnet  process.  This  involves  recogni- 
tion of  Telnet  IACs  and  the  translation  of  Carriage 
*eturn(CR)  and  Line  Feed(LF)  to  Line  Feed  on  all  data  re- 
eived  from  the  network/  and  the  inverse  translation  of  LF 
to  CR  LF  on  all  data  sent  to  the  network. 


>ICP  Structure 

Due  to  the  structure  of  both  the  IMP  to  HostC2D  and 
lost  to  HostC33  network  protocols/  data  comes  from  the  net- 
work destined  not  only  for  one  of  many  active  processes/  but 
for  the  information  of  the  local  host  as  a  whole.  For  exam- 
)le/  network  traffic  such  as  a  Host  to  Host  Reset/  which 
generally  signals  that  a  foreign  host  has  come  "olive"  must 
)e  acknowledged  to  let  that  host  know  that  the  local  host 
itself  is  "alive".  Therefore/  the  local  host  must  monitor 
lata  coming  from  the  net  to  perform  not  only  a  message 
switching  function/  which  is  the  bulk  of  network  traffic/ 
>ut  to  provide  a  control  and  status  function. 


Further/   when 
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wishes  to   carry  on   a   conversation   with   a   network 

r/   the   Initial  Connection  ProtocolC]  must  be  used  to 

de  a  logical  port  at  each  site  for  succeeding   informa- 
f  low. 

Experience  with  the  ANTS  Mark  IC43  and  ANTS  Mark 
systems  has  shown  that  the  above  classes  of  network 
s  are  relatively  infrequent/-  and  that  most  network 
ic  is  in  terms  of  user  data  flow  and  the  associated 
controK  Host  to  Most  Allocates  and  IMP  to  Host  RFNMs). 
s  also  the  case  that  the  software  required  to  implement 
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Hardware  and  Software  Requirements 
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The  base  operating  system  occupies  24.5k  words  of 
memory.  This  system  includes  a  large  number  of  device 
drivers*-  and  enjoys  a  generous  amount  of  space  for  I/O 
buffers  and  system  tables.  A  minimal  system  would  require 
40k  words  of  memory.  It  should  be  noted  that  UNIX  also 
requires  the  memory  management  option  offered  by  DEC  to  run 
at  all. 


The  base  operating  system  was  developed  by  3ell 
Laboratories  in  Murray  Hill*  New  Jersey.  The  Bell  installa- 
tion supports  a  high  speed  paper  tape  reader-punch/-  nine- 
track   magnetic   tape/   and   Dectape.   3esides   the   console 
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terminal/-  there  are  14  variabte  speed  communication  d  a  - 
tasets/-  and  a  201  series  dataset  for  spooling  printout  to  a 
communal  line  printer.  There  are  also  several  one-of-a-kind 
devices  including  a  voice  response  unit/  a  voice  synthesiz- 
er/ a  phototypesetter/  a  digital  switching  networks  and  a 
satellite  PDP-11/20  which  generates  vectors/-  curves/-  and 
;haracters  for  a  Tektronix  611  storage-tube  display. 


Pliability 

As  of  this  writing  network  UNIX  has  been  running  on 
i  full  time  basis  for  about  four  weeks.  During  that  period/ 
;here  were  between  three  and  four  crashes  a  day.  This  is 
lot  a  valid  indicator  because  many  of  the  failures  were   due 

o      hardware   problems.   More  recently  the  hardware  has  been 

e-conf i gured  to  improve  reliability  and  the  crash  rate  has 
ieen   reduced   to  one  a  day  with  a  down  time  of  2-5  minutes. 

his  is  expected  to  continue/-  but  the  sampling  period   hasnt 

een  long  enough  for  any  dependable  analysis. 


vailability 

Although   the   UNIX   network  software  was  developed 

ithout  ARPA  supports  the  Center  for  Advanced  Computation  is 

illing   to  provide  it  gratis  to  trie  people  of  the  ARPA  corn- 
unity  . 

However/-  Bell  Laboratories  must  be  contacted  for  a 
icense  to  the  base  system  itself.  Bell's  policy  in  the 
ast  has  been  to  license  the  system  to  universities  for  a 
Dminal  fee/-  $150.00/-  and  unfortunately  for  a  cost  of 
20/000.00  to  "non-university"  institutions. 

In  this  light/  Bell  was  approached  to  see  what  their 
e action  would  be  to  an  ARPA  Network  wide  license.  They  said 
hat  they  were  open  'to  suggestions. in  that  area.  S  o  /■  should 
nough  people  desire  a  system/  perhaps  a  less  expensive 
icense  fee  can  be  negotiated. 

In  any  case  we  are  willing  to  help  any  group  with 
cquisition  of  a  system. 


For   further   information  concerning  the  system  con- 


act 


Steve  Holagren 

Center  for  Advanced  Computation 
University  of  Illinois- 
Urbana  Illinois  61801 


<217)-333~8469 
or 
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holngren  at  i  si 


Outlook  and  Future  Plans 


With  the  advent  of  Telnet  in  UMIX/  current  plans  are 

to  run  the  system  over  the  next  one  or  two  months  and   work 

out   any   remaining  bugs.   While  this  is  going  on/-  extensive 

Dandwidth  and  load  testing  is  going  to  take   place  and   any 
reasonable  improvements  made. 


After  Telnet  has  proved  itself  reliable/  the  Open 
system  call  will  be  expanded  to  include  further  parameteri- 
zation. This  parameterization  will  encompass  connections  to 
specific  sockets^  simplex  connections  based  on  a  socket 
already  in  use/  and  the  ability  to  listen  on  a  local  socket. 

After  those  extensions/  net  mail/  then  network  FTP 
and  finally  network  RJE  will  be  implemented.  All  will  run 
as  user  programs  so  the  size  of  the  system  kernel  will  not 
i  ncrease . 

Ultimately/  Server  Telnet  and  Server  FTP  may  be 
incorporated  into  the  system/  but  they  are  not  a  priority 
piece  of  work. 

There  is  also  interest  in  implementing  some  of  the 
Procedure  Call  Protocol  being  developed  by  the  National 
Software  Works/  but  no  definite  plans  have  been  made. 
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